home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1998 May / Macworld (1998-05).dmg / Serious Demos / OffLine Unboxed / OffLine™ 4.5 - Manual / OffLine™ 4.5 - Manual.rsrc / TEXT_128.txt < prev    next >
Text File  |  1998-02-17  |  22KB  |  288 lines

  1. Introduction
  2.  
  3. Welcome to OffLine, the disk manager‚Äî we believe to be the complete solution to disk and Ô¨Åle management.
  4.  
  5. OffLine is unique among Macintosh disk utilities. Unlike other utilities, it was designed to keep track of unmounted ‚Äî or ofÔ¨Çine ‚Äî disks. This means that, once the program knows about your disks, it can perform all of its functions without requiring you to mount them.
  6.  
  7. OffLine keeps track of your disk Ô¨Åles in its own database, or catalog, which resides on your hard drive. The Ô¨Årst time you launch OffLine, it creates and opens a catalog called ‚ÄúOffLine‚Ñ¢ Catalog‚Äù in the folder from which you launched OffLine. The name and location of this catalog is ‚Äúremembered‚Äù between sessions, so it is always opened automatically when you launch OffLine.
  8.  
  9. If you wish, you may create and use additional catalogs, and switch among them at will. At any given time, however, only one catalog can be active.
  10.  
  11. The program‚Äôs functions all access the active catalog automatically, and are based on four components of the program, called ‚Äúengines‚Äù:
  12.  
  13. The Catalog Engine
  14.  
  15. While traditional databases require you to enter information, OffLine does this automatically. Scanning (cataloging) a disk (i.e., getting its information into the catalog) is as simple as inserting it into the disk drive (in the case of Ô¨Çoppies and zip cartridges) or clicking a button to select a disk on your desktop. All the information about the disk and its Ô¨Åles is quickly stored in the catalog. If the disk is a Ô¨Çoppy or zip cartridge, it is ejected, whereupon you may insert the next disk to be cataloged. This can be repeated as many times as you like, whenever you like. If you have attached a comment to a Ô¨Åle using Finder‚Äôs Get Info command, then OffLine will retrieve it, and attach it to the Ô¨Åle‚Äôs entry in your catalog.
  16.  
  17. When cataloging Ô¨Åles, OffLine recognizes and performs special processing on StuffIt‚Ñ¢ (including the Classic and Deluxe versions), Compact Pro‚Ñ¢, and AppleLink‚Ñ¢  archives. The catalog engine automatically extracts information about each Ô¨Åle in an archive, making a separate catalog entry for each. Similarly, the catalog engine includes intelligent support for Ô¨Åles compressed by DiskDoubler‚Ñ¢.
  18.  
  19. The Search Engine
  20.  
  21. Once your disks have been cataloged, you can locate any Ô¨Åle or group of Ô¨Åles with ease. The search engine offers an extremely Ô¨Çexible array of search options, ranging from simple to sophisticated. When OffLine has found what you were looking for, it tells you all about each Ô¨Åle, and ‚Äî most importantly ‚Äî on what disk each Ô¨Åle is located.
  22.  
  23. OffLine provides two levels, or methods, for searching the catalog: Basic and Advanced. The basic search method allows you to Ô¨Ånd any Ô¨Åle, or group of Ô¨Åles, by specifying a disk and/or scanning the catalog for Ô¨Åle names that contain a search string that you provide. You can further restrict your search to Ô¨Åles created by a particular application. OffLine lists all the Ô¨Åles that match your search criteria. A single click on any of the Ô¨Åles found reveals its full path name, size, creation date, modiÔ¨Åcation date or version number, Finder label (under System 7.0 or later), and the name of the application that created it. If you click on a Ô¨Åle that is contained in a StuffIt, Compact Pro, or AppleLink archive, the name and location of that archive is displayed.
  24.  
  25. The Advanced search method was designed for users who are familiar with Macintosh Ô¨Åle signatures (types and creators), and who need the Ô¨Çexibility to conduct highly sophisticated searches of the catalog. This search method allows you to search on any combination of name, type, creator, and Finder label (System 7.0 or later), and displays signature information about the Ô¨Åles that are found.
  26.  
  27. The Print Engine
  28.  
  29. Even when you know what disk to look for in your collection, Ô¨Ånding a speciÔ¨Åc disk can be time-consuming, especially if your disk labels are out of date, inconsistent, or even non-existent. OffLine‚Äôs print engine offers a simple and elegant solution, by printing clear, professional-looking Ô¨Çoppy disk labels on standard label sheets designed for laser and inkjet printers.
  30.  
  31. If you‚Äôre a real stickler for organization, and want the ability to physically locate a disk fast, then you will want to take advantage of OffLine‚Äôs automatic numbering feature. When a disk is cataloged, OffLine assigns it a unique serial number. When you print disk labels for Ô¨Çoppy disks, you can elect to have the serial numbers printed on the labels, so you can physically Ô¨Åle your disks by number. This makes locating a desired disk quick and effortless.
  32.  
  33. The Export Engine
  34.  
  35. Finally, we recognize that information is a valuable resource, and that we cannot possibly anticipate all the creative uses to which you may want to put this information. So we made it very easy to export the contents of the catalog for use in virtually any other application ‚Äî even those on non-Macintosh computers.
  36.  
  37. What You Need
  38.  
  39. Software Requirements
  40.  
  41. OffLine requires System version 6.0.5 or later, and is System 7 and MacOS8 friendly, offering a number of features that are available only if you are running System 7.0 or later.
  42.  
  43. OffLine supports Balloon Help‚Ñ¢ under System 7 or MacOS8. To get help, simply turn on Balloon Help and pass the cursor over an object on the screen.
  44.  
  45. Hardware Requirements
  46.  
  47. OffLine will run on Macintosh Plus or later model  computers with a hard disk. Label printing requires a page printer (laser or inkjet) that supports either QuickDraw or PostScript.
  48.  
  49. Other Requirements
  50.  
  51. If you wish to print Ô¨Çoppy disk labels, you‚Äôll need  sheet-fed adhesive labels (Avery # 5196 or equivalent). These are available from many computer and office supply dealers.
  52.  
  53. Getting Started
  54.  
  55. Using OffLine
  56.  
  57. The Ô¨Årst time you launch OffLine, it creates and opens a catalog named ‚ÄúOffLine‚Ñ¢ Catalog‚Äù in the folder from which you launched the program. When you quit the program, OffLine saves the name and location of the catalog in a document named ‚ÄúOffLine Prefs‚Äù in a folder named ‚ÄúPreferences‚Äù in your System folder. Therefore, each time you launch the program, it opens the most recently used catalog.
  58.  
  59. Whenever you launch OffLine, its main window appears, containing information about the catalog. Because your catalog will initially be empty, the Ô¨Årst thing to do is to catalog one or more disks.
  60.  
  61. Creating Disk Catalogs
  62.  
  63. Choose Scan Disks‚Ķ from the File menu. OffLine‚Äôs ‚ÄúScan Disks‚Äù dialog box appears. To catalog a Ô¨Çoppy disk or zip cartridge, simply insert it into the drive. Within a few seconds, OffLine will mount the disk, add it to the catalog, and eject the disk. To catalog a group of disks, simply insert them, one after another.
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95. To catalog any other disk on your desktop, click the Drive button, until you see the disk you want, then click the Scan Disk button.
  96.  
  97. Don‚Äôt worry if you‚Äôre not sure whether a disk has already been cataloged. When OffLine determines that a disk is already in the catalog, it refreshes the catalog, removing references to Ô¨Åles that are no longer on the disk, adding any new Ô¨Åles, and updating dates and sizes, as required.
  98.  
  99. OffLine ‚Äúknows‚Äù whether a disk has been previously cataloged by comparing not only its name, but also its initialization date, to those in the catalog. If you insert a disk that has never been cataloged ‚Äî but has the same name as a disk that has been cataloged ‚Äî then OffLine will alert you, and suggest that you use the Rename checkbox to eliminate the duplication.
  100.  
  101. For inquiring minds, here‚Äôs a description of the check boxes,  buttons, and messages.
  102.  
  103. The ‚ÄúSerial number‚Äù popup menu allows you to control how serial numbers will be assigned to new disks in the catalog. You can choose:
  104. ‚Ä¢    ‚ÄúNext sequential,‚Äù which tells OffLine to assign a number one greater than the highest serial number in the catalog.
  105. ‚Ä¢    ‚ÄúFirst available,‚Äù which assigns the lowest available serial number. This is useful if you have uncatalogued a disk, and wish to re-use its serial number.
  106. ‚Ä¢    Or, if there are gaps in the serial numbers (because you have uncatalogued one or more disks), you can choose a particular serial number from among those that are unused.
  107.  
  108. Tell OffLine what kind of disk is being scanned using the ‚ÄúDisk Type‚Äù popup menu.  This will be useful later when searching for a particular file, and want to know what kind of disk it is on.
  109.  
  110. By default, the Auto-Catalog option is checked. This means that OffLine will mount, catalog, and eject a Ô¨Çoppy disk or zip cartridge as soon as you insert it in the drive. If this box is unchecked, however, the disk will be mounted, and its name will be displayed in the upper-left corner of the dialog ‚Äî but the cataloging will not begin until you click the Scan Disk button.
  111.  
  112. There are two reasons why you might want to uncheck the Auto-Catalog‚Ķ box. First, you have the opportunity to change your mind if you decide that you don‚Äôt want a particular Ô¨Çoppy or zip cataloged: Simply click the Eject button to remove the disk without cataloging it.
  113.  
  114. Second, cataloging disks provides a good opportunity to think more systematically about how you name your disks. You may Ô¨Ånd, once a disk has been mounted, that the disk‚Äôs name is confusing or obsolete. Clicking the Rename disk‚Ķ box displays a text box in which you can type a new name for the disk. The name you enter will be used to rename the disk before it is cataloged.
  115.  
  116. The Rename disk‚Ķ check box is disabled if the disk you inserted is locked. If you wish to rename a locked disk, eject the disk, unlock it, then insert it again.
  117.  
  118. The Ignore system Ô¨Åles box is normally checked. This option acts as a Ô¨Ålter that prevents common Macintosh system Ô¨Åles (e.g., ‚ÄúDesktop‚Äù, ‚ÄúFinder‚Äù, ‚ÄúSystem‚Äù) from being cataloged. If you want system Ô¨Åles on your disks to be cataloged, click the box to uncheck it.
  119.  
  120. The Status area displays informational messages. If no drive has been selected, the message reads ‚ÄúWaiting for disk.‚Äù  During the period in which a disk is being cataloged, the message reads ‚ÄúCataloging‚Äù, then ‚ÄúSaving entries‚Äù.
  121.  
  122. Once a disk has been cataloged, the message tells you the unique serial number that OffLine has assigned to the disk. This is the number that will be printed on the disk label if you choose that option (see Printing Labels, below).
  123.  
  124. Using the Search Engine
  125.  
  126. The appearance and operation of the Search window depends on your choice of search method. At any given time, you can use either the Basic Search or the Advanced Search method by selecting it from the Options menu.
  127.  
  128. Basic Search Method
  129.  
  130. The basic Search window consists of several sections. Counter-clockwise from the top, they are:
  131.  
  132. ‚Ä¢ Request Area (top section)
  133. ‚Ä¢    Disk List (left middle)
  134. ‚Ä¢    Info Area (left bottom)
  135. ‚Ä¢    Results List (right bottom)
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163. Request Area
  164.  
  165. The request area, on top, is where you deÔ¨Åne your search criteria. You can elect whether to search for Ô¨Åles on a particular disk or on all disks. You can limit the search to Ô¨Åles in the catalog whose names match a particular string of characters, called a search string. You can also restrict your search to those Ô¨Åles created by a particular application, by selecting the desired application from the popup menu labeled ‚ÄúCreated by.‚Äù
  166.  
  167. The popup menu below ‚ÄúName‚Äù extends the power of string searches by allowing you to control how strings are matched. This menu, which applies only when you specify a search string, contains the following choices:
  168.  
  169. ‚Ä¢    Contains ‚Äî Catalog entries whose names contain the search string will be found
  170. ‚Ä¢    Starts with ‚Äî Catalog entries whose names begin with the search string will be found
  171. ‚Ä¢    Ends with ‚Äî Catalog entries whose names end with the search string will be found
  172. ‚Ä¢    Equals ‚Äî Catalog entries whose names exactly match the search string will be found
  173.  
  174. The string matching method defaults to Contains. Regardless of which method you use, case is not signiÔ¨Åcant: ‚ÄúJuly‚Äù and ‚ÄúJULY‚Äù are treated as matches.
  175.  
  176. The checkbox labeled Include folders allows you to extend the scope of a string search to folders and archives as well as Ô¨Åles. For example, suppose you type ‚ÄúJuly‚Äù as a search string. If the checkbox is not checked, then OffLine will Ô¨Ånd all Ô¨Åles whose names match ‚ÄúJuly‚Äù (assuming they match any other criteria you may have speciÔ¨Åed). However, when the Include folders checkbox is checked, OffLine will also Ô¨Ånd Ô¨Åles within folders and archives whose names match ‚ÄúJuly,‚Äù even if the Ô¨Åle names themselves don‚Äôt match the search string.
  177.  
  178. The checkbox labeled Include comments allows you to extend the scope of a string search to comments attached to Ô¨Åles, as well as the Ô¨Åles themselves. For example, suppose you type ‚ÄúApple‚Äù as a search string. If this checkbox is checked, then OffLine will Ô¨Ånd not only Ô¨Åle names that match, but also Ô¨Åles whose comments contain ‚ÄúApple.‚Äù 
  179.  
  180. The checkbox labeled Selected disk only allows you to decide whether your search will cover the entire catalog, or just those entries on a selected disk. If you know which disk contains the Ô¨Åles you are looking for, then select the disk in the Disk List, and check the box. The search will be much faster.
  181.  
  182. Disk List
  183.  
  184. Disk names are sorted alphabetically. To change the sort order, use the ‚ÄúSort by‚Äù popup menu. 
  185.  
  186. Whenever you select a disk from the Disk List, information about the selected disk is displayed in the Info area.
  187.  
  188. You can browse the entire contents of a disk by double-clicking or option-clicking a disk in the Disk List. A dialog box will appear containing a graphical view of the folders and Ô¨Åles on the disk. If there are any archives, then each will be represented by the icon belonging to the application that created it (i.e., StuffIt, Compact Pro, or AppleLink), and its component Ô¨Åles will appear below. Click on any Ô¨Åle to see information about it.
  189.  
  190. If, for some reason, you wish to uncatalog a disk, simply click on the disk icon in the Info Area and drag it to OffLine‚Äôs trash can. This action removes information about the disk from the catalog, but has no effect on the disk itself. Note that the serial number assigned to the disk will never again be used in the active catalog, even if you recatalog the same disk at a later time.
  191.  
  192. Results List
  193.  
  194. After clicking the Search button, the Results List is Ô¨Ålled with all the Ô¨Åles that matched your request, together with the names of the disks on which they are found. Clicking on the name of a Ô¨Åle in the Results List displays information about that Ô¨Åle.
  195.  
  196. If you click on a Ô¨Åle name, then a File Info icon appears in right side of the Info area. Click on this icon to attach a comment (up to 200 characters) to that Ô¨Åle‚Äôs catalog entry, or to view and edit an existing comment. Double-clicking on a Ô¨Åle name has the same effect.
  197.  
  198. It‚Äôs easy to tell whether a Ô¨Åle has an existing comment. Files with attached comments are displayed in boldface type.
  199.  
  200. The box surrounding the ‚ÄúFile Name‚Äù column heading indicates that the results list is sorted by Ô¨Åle name. To view the list sorted by disk name, click on the ‚ÄúDisk‚Äù column heading.
  201.  
  202. If you want to save the results of your search for later perusal, or for use in another application, click the Export button. The format in which your search results are saved is determined by your choice in the ‚ÄúExport preferences‚Äù dialog, accessed from the Edit menu (see Export Preferences, below).
  203.  
  204. To illustrate a string search, you could type the word ‚Äúideas‚Äù in the text box (top center), and click the Search button.
  205.  
  206. The Results List shows all the Ô¨Åles in the catalog whose names contain the string ‚Äúideas‚Äù. Click on any item in the Ô¨Åle list, and its attributes appear in the Info area below. If the selected Ô¨Åle is a program (application, system extension, etc.) that contains a version number, then the version number will be displayed instead of a modiÔ¨Åcation date. If you are running System Software 7.0 or later, then the Ô¨Åle‚Äôs label (as assigned in the Finder) will appear.
  207.  
  208. When performing a search, you can also narrow the search request to Ô¨Ånd only those Ô¨Åles created by a particular application. To Ô¨Ånd all HyperCard documents on all the cataloged disks, make sure the checkbox labeled ‚ÄúSelected disk only‚Äù is not checked (so that the search is not limited to a single disk), then Select ‚ÄúHyperCard‚Äù from the ‚ÄúCreated by‚Äù popup menu.
  209.  
  210. Whenever you catalog a disk containing an application previously unknown to OffLine, that application is permanently added to the ‚ÄúCreated by‚Äù popup menu.
  211.  
  212. Advanced Search Method
  213.  
  214. If you use OffLine‚Äôs Advanced Search Method, you will see more popup menus in the Search window, and additional Ô¨Åle information displayed in the Info Area.
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225. The popups on the right allow you to restrict your search to Ô¨Åles whose signatures (types and creators) match what you select from the menus.
  226.  
  227. If you are running System 7.0 or later, you can use the Labels popup menu to further restrict your search to Ô¨Åles having a particular Finder label.
  228.  
  229. Note what happens, for example, if you limit your search to those Ô¨Åles whose type is ‚ÄúSTAK‚Äù and whose creator is ‚ÄúWILD‚Äù (these comprise the signature for all HyperCard stacks). After clicking on the Search button, the Results list is Ô¨Ålled with all the HyperCard stacks in the catalog.
  230.  
  231. Files contained in a StuffIt‚Ñ¢, Compact Pro‚Ñ¢, or AppleLink‚Ñ¢  archive are marked with ‚Äú¬ª‚Äù. If you click on one of these Ô¨Åles, then the archive‚Äôs name (instead of the Ô¨Åle‚Äôs folder path) is displayed in the Info area. Files that have been compressed by DiskDoubler‚Ñ¢ have ‚Äú(DD)‚Äù appended to the Ô¨Åle‚Äôs description in the File Info area.
  232.  
  233. You can combine different restrictions in your search request. If you enter ‚Äústack‚Äù as a search string, and choose ‚ÄúSTAK‚Äù and ‚ÄúWILD‚Äù with the signature popups, then all HyperCard stacks whose names contain the search string are displayed.
  234.  
  235. Similarly, you could restrict your search to all Ô¨Åles having a particular signature and residing on a particular disk. Simply select a disk by clicking in the Disk List, check the check box above the Disk List, and choose the signature from the popup menus.
  236.  
  237. Whenever you catalog a disk containing an application previously unknown to OffLine, that application‚Äôs Ô¨Åle type and creator are permanently added to the Type and Creator popup menus.
  238.  
  239. Adding and Editing Comments
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256. Whenever Ô¨Åle names appear in the Ô¨Åle list, you can annotate any individual Ô¨Åle with a free-form comment. Either select a Ô¨Åle, then click on the File Info icon, or double-click on the name of a Ô¨Åle. A comment dialog box appears. Type any comment up to 200 characters, just as you would in Finder‚Äôs Get Info box. If you click on the OK button, the comment will be permanently saved in the active catalog. 
  257.  
  258. When you perform a search, and Ô¨Åle names appear in the Ô¨Åle list, you can tell at a glance which Ô¨Åles have comments attached to them. Files with comments are displayed in boldfaced text. If you double-click on a Ô¨Åle that already has a comment, the comment will be displayed, and you can edit it if you wish.
  259.  
  260. To search for Ô¨Åles whose comments contain a particular string, check the ‚ÄúInclude comments‚Äù checkbox.
  261.  
  262. Tips & Tricks in the Search Window
  263.  
  264. To get an instant look at statistics about the active catalog, option-press the window‚Äôs title bar. As long as you hold the mouse button down, catalog statistics will appear in the File Info area at the bottom of the window. For more complete information, choose Statistics‚Ķ from the File menu.
  265.  
  266. Both the Disk List and the Results List support auto-scrolling. Instead of using the scroll bars to move through a list, you can press and hold the mouse button as you move the cursor toward the top or bottom of a list. When the cursor reaches the top or bottom, the list will scroll automatically. If your keyboard has arrow keys, then these will also scroll the lists.
  267.  
  268. Double-click or option-click on a disk name to browse the contents of a disk. This opens the browse window, which contains a Finder-like view of all the items on the disk. To expand a folder, just click on its arrow. To collapse a folder, click on its arrow again.
  269.  
  270. Double-click on a Ô¨Åle name to add or edit a comment attached to the Ô¨Åle. File names displayed in boldfaced text have comments attached to them.
  271.  
  272. Sort the Disk List by free space, to help you learn which of your disks has enough room to accommodate a particular Ô¨Åle or folder.
  273.  
  274. To remove a disk from the catalog, select it in the Disk List, then drag its icon (in the Info area) to OffLine‚Äôs trash.
  275.  
  276. If your catalog is very large (say, over 10,000 Ô¨Åles), and you Ô¨Ånd that searching is getting slow, consider creating new catalogs, and dividing your disks among them in a way that makes sense to you.
  277.  
  278. When you perform a string search, pop up the string search menu to gain further control over how strings are matched.
  279.  
  280. If you know which disk contains the document(s) for which you‚Äôre searching, then select that disk and check the ‚ÄúSelected disk only‚Äù checkbox. The search will be completed much faster.
  281.  
  282. Available memory places limitations on the number of Ô¨Åles OffLine can display in the Results List. If your catalog is large, and you perform a very broad search (e.g., all Ô¨Åles that contain the letter ‚Äùa‚Äù), there may be more matching entries than can be displayed, and the following alert will appear:
  283.  
  284. This often means that you cast too broad a net in your search request. If you click Cancel, you can try again with more speciÔ¨Åc search criteria.
  285.  
  286.     If you really want to Ô¨Ånd all the Ô¨Åles that match your request, then click ‚ÄùExport the matches,‚Äù and OffLine will direct its report of all matching Ô¨Åles to a document that you can peruse and print with any word processor, spreadsheet, or database management system. The format of this report is determined by your choice of export format (choose Export preferences‚Ķ from the Edit menu).
  287.  
  288.